home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / tpmv.z / tpmv
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  115 lines
  1. TPMV(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSTTPPMMVV, DDTTPPMMVV, CCTTPPMMVV, ZZTTPPMMVV - Multiplies a real or complex vector by a
  6.      real or complex triangular packed matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSTTPPMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a_p,, _x,, _i_n_c_x))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDTTPPMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a_p,, _x,, _i_n_c_x))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCTTPPMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a_p,, _x,, _i_n_c_x))
  20.  
  21.      Double complex
  22.  
  23.         CCAALLLL ZZTTPPMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a_p,, _x,, _i_n_c_x))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      These routines perform one of the following matrix-vector operations:
  30.  
  31.           _x <- _A_x
  32.                 _T
  33.           _x <- _A _x
  34.                 _H
  35.           _x <- _A _x (CCTTPPMMVV, ZZTTPPMMVV only)
  36.             _T                         _H
  37.      where _A  is the transpose of _A, _A  is the conjugate transpose of _A, _x
  38.      is an _n-element vector, and _A may be either a unit or nonunit _n-by-_n
  39.      upper or lower triangular matrix.
  40.  
  41.      These routines have the following arguments:
  42.  
  43.      _u_p_l_o      Character*1.  (input)
  44.                Specifies whether the matrix is an upper or lower triangular
  45.                matrix, as follows:
  46.  
  47.                _u_p_l_o = 'U' or 'u':  _A is an upper triangular matrix.
  48.                _u_p_l_o = 'L' or 'l':  _A is a lower triangular matrix.
  49.  
  50.      _t_r_a_n_s     Character*1.  (input)
  51.                Specifies the operation to be performed, as follows:
  52.  
  53.                _t_r_a_n_s = 'N' or 'n':  _x <- _A_x
  54.  
  55.                                           _T
  56.                _t_r_a_n_s = 'T' or 't':  _x <- _A _x
  57.  
  58.                                           _T                            _H
  59.                _t_r_a_n_s = 'C' or 'c':  _x <- _A _x  (SSTTPPMMVV, DDTTPPMMVV), or _x <- _A _x
  60.                (CCTTPPMMVV, ZZTTPPMMVV)
  61.  
  62.      _d_i_a_g      Character*1.  (input)
  63.                Specifies whether _A is unit triangular, as follows:
  64.  
  65.                _d_i_a_g = 'U' or 'u': _A is assumed to be unit triangular.
  66.                _d_i_a_g = 'N' or 'n': _A is not assumed to be unit triangular.
  67.  
  68.      _n         Integer.  (input)
  69.                Specifies the order of matrix _A.  _n >= 0.
  70.  
  71.      _a_p        Array of dimension (_n(_n+1))/2.  (input)
  72.                SSTTPPMMVV: Real array.
  73.                DDTTPPMMVV: Double precision array.
  74.                CCTTPPMMVV: Complex array.
  75.                ZZTTPPMMVV: Double complex array.
  76.  
  77.                Before entry with _u_p_l_o = 'U' or 'u', array _a_p must contain
  78.                the upper triangular matrix packed sequentially,
  79.                column-by-column, so that _a_p(1) contains _A(1,1), _a_p(2)
  80.                contains _A(1,2), _a_p(3) contains _A(2,2), and so on.
  81.  
  82.                Before entry with _u_p_l_o = 'L' or 'l', array _a_p must contain
  83.                the lower triangular matrix packed sequentially,
  84.                column-by-column, so that _a_p(1) contains _A(1,1), _a_p(2)
  85.                contains _A(2,1), _a_p(3) contains _A(3,1), and so on.
  86.  
  87.                When _d_i_a_g = 'U' or 'u', these routines assume that all
  88.                elements of the array _a that represent diagonal elements of
  89.                the matrix _A are 1.  In this case, neither of these routines
  90.                will reference any of the diagonal elements.
  91.  
  92.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input and output)
  93.                SSTTPPMMVV: Real array.
  94.                DDTTPPMMVV: Double precision array.
  95.                CCTTPPMMVV: Complex array.
  96.                ZZTTPPMMVV: Double complex array.
  97.                Contains the vector _x.  On exit, the transformed vector
  98.                overwrites array _x.
  99.  
  100.      _i_n_c_x      Integer.  (input)
  101.                Specifies the increment for the elements of _x.  _i_n_c_x must
  102.                not be 0.
  103.  
  104. NNOOTTEESS
  105.      These routines are Level 2 Basic Linear Algebra Subprograms (Level 2
  106.      BLAS).
  107.  
  108.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  109.      the vector and moves backward, as follows:
  110.  
  111.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  112.  
  113. SSEEEE AALLSSOO
  114.      This man page is available only online.
  115.